Crate reqsign

Signing API requests without effort.

Example

use anyhow::Result;
use reqsign::AwsConfigLoader;
use reqsign::AwsV4Signer;
use reqwest::Client;
use reqwest::Request;
use reqwest::Url;

#[tokio::main]
async fn main() -> Result<()> {
    // Signer can load region and credentials from environment by default.
    let signer = AwsV4Signer::builder()
        .config_loader(AwsConfigLoader::with_loaded())
        .service("s3")
        .allow_anonymous()
        .build()?;
    // Construct request
    let url = Url::parse("https://s3.amazonaws.com/testbucket")?;
    let mut req = reqwest::Request::new(http::Method::GET, url);
    // Signing request with Signer
    signer.sign(&mut req)?;
    // Sending already signed request.
    let resp = Client::new().execute(req).await?;
    println!("resp got status: {}", resp.status());
    Ok(())
}

Available Services

• Aliyun OSS for Aliyun OSS.
• AWS SigV4 for AWS services like S3.
• Azure Storage for Azure Storage services like Azure Blob Service.
• Google for All google cloud services like Google Cloud Storage Service.
• Huawei Cloud OBS for Huawei Cloud Object Storage Service (OBS).

Features

reqsign support http::Request by default. Other request types support are hided under feature gates to reduce dependencies.

• reqwest_request: Enable to support signing reqwest::Request
• reqwest_blocking_request: Enable to support signing reqwest::blocking::Request
• http_types_request: Enable to support signing http_types::Request

Re-exports

• pub use credential::CredentialLoad as AwsCredentialLoad;

Modules

• credential
  Provide Credential for most services.

Structs

• AliyunOssBuilder
  Builder for Signer
• AliyunOssSigner
  Singer for Aliyun OSS.
• AwsConfigLoader
  Config loader that will load config from different source.
• AwsCredentialLoader
  CredentialLoader will load credential from different methods.
• AwsV4Builder
  Builder for Signer.
• AwsV4Signer
  Singer that implement AWS SigV4.
• AzureStorageBuilder
  Builder for Signer.
• AzureStorageSigner
  Singer that implement Azure Storage Shared Key Authorization.
• GoogleBuilder
  Builder for Signer.
• GoogleSigner
  Singer that implement Google OAuth2 Authentication.
• GoogleToken
  Token is the authentication methods used by google services.
• HuaweicloudObsBuilder
  Builder for Signer.
• HuaweicloudObsSigner
  Singer that implement Huawei Cloud Object Storage Service Authorization.

Traits

• GoogleTokenLoad
  TokenLoad will be used to load token.